home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmRenderTableAddRenditions.z
/
XmRenderTableAddRenditions
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeXXXXmmmmmmmmRRRRVVVVeeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss - Creates a new render table
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss(
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee oooollllddddttttaaaabbbblllleeee,
XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnn ****rrrreeeennnnddddiiiittttiiiioooonnnnssss,
CCCCaaaarrrrddddiiiinnnnaaaallll rrrreeeennnnddddiiiittttiiiioooonnnn____ccccoooouuuunnnntttt,
XXXXmmmmMMMMeeeerrrrggggeeeeMMMMooooddddeeee mmmmeeeerrrrggggeeee____mmmmooooddddeeee);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss is a function to create a new
render table that includes the renditions listed in
_o_l_d_t_a_b_l_e, if there is one. This function also copies
specified renditions (_r_e_n_d_i_t_i_o_n_s) to the new render table.
The first _r_e_n_d_i_t_i_o_n__c_o_u_n_t renditions of the _r_e_n_d_i_t_i_o_n_s array
are added to the new table. If a rendition is tagged with a
tag that matches a tag already in _o_l_d_t_a_b_l_e, then the
existing rendition using that tag is either modified or
freed and replaced with the new rendition, depending on the
value of _m_e_r_g_e__m_o_d_e. If _o_l_d_t_a_b_l_e is NULL,
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss creates a new render table
containing only the specified renditions.
This function deallocates the original render table after
extracting the required information. It is the
responsibility of the caller to free the renditions of the
_r_e_n_d_i_t_i_o_n_s array by calling the XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnnFFFFrrrreeeeeeee function.
_o_l_d_t_a_b_l_e Specifies the render table to be added to.
_r_e_n_d_i_t_i_o_n_s
Specifies an array of renditions to be added.
_r_e_n_d_i_t_i_o_n__c_o_u_n_t
Specifies the number of renditions from _r_e_n_d_i_t_i_o_n_s
to be added.
_m_e_r_g_e__m_o_d_e
Specifies what to do if the XXXXmmmmNNNNttttaaaagggg of a rendition
matches that of one that already exists in
_o_l_d_t_a_b_l_e. The possible values are as follows:
XXXXmmmmMMMMEEEERRRRGGGGEEEE____RRRREEEEPPPPLLLLAAAACCCCEEEE
Completely replaces the old rendition
with the new one.
XXXXmmmmMMMMEEEERRRRGGGGEEEE____OOOOLLLLDDDD
Page 1 (printed 10/24/98)
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeXXXXmmmmmmmmRRRRVVVVeeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((3333XXXX))))
Replaces any unspecified values of the
old rendition with the corresponding
values from the new rendition.
XXXXmmmmMMMMEEEERRRRGGGGEEEE____NNNNEEEEWWWW
Replaces the old rendition with the new
rendition, replacing any unspecified
values of the new rendition with the
corresponding values from the old
rendition.
XXXXmmmmSSSSKKKKIIIIPPPP Skips over the new rendition, leaving
the old rendition intact.
RRRREEEETTTTUUUURRRRNNNN
If _r_e_n_d_i_t_i_o_n_s is NULL or _r_e_n_d_i_t_i_o_n__c_o_u_n_t is 0 (zero), this
function returns _o_l_d_t_a_b_l_e. Otherwise, the function returns
a new XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee. The function allocates space to hold
this new render table. The application is responsible for
managing this allocated space. The application can recover
the allocated space by calling XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeFFFFrrrreeeeeeee.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnn(3) and XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeFFFFrrrreeeeeeee(3).
Page 2 (printed 10/24/98)